home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / dtype / fontdt12.lha / AutoDocs / font_dtc.doc
Text File  |  1996-05-06  |  3KB  |  65 lines
  1. TABLE OF CONTENTS
  2.  
  3. font.datatype/font.datatype
  4. font.datatype/font.datatype                       font.datatype/font.datatype
  5.  
  6.    NAME
  7.        font.datatype -- data type for Amiga bitmap and outline fonts.
  8.  
  9.    FUNCTION
  10.        The font data type, a sub-class of the picture.datatype, is used
  11.        to load (and display) Amiga bitmap and outline fonts. All available
  12.        sizes of a given font are loaded into memory and then rendered into
  13.        screen, taking user preferences into account.
  14.        By default this data type will render each font size in one line,
  15.        in ascending order. Whole characters set for the given font and size
  16.        will be rendered.
  17.  
  18.        User preferences are stored in font.prefs file, located in either
  19.        PROGDIR:Prefs/DataTypes/ or ENV:DataTypes/ directory (searched in
  20.        that order). A preferences file is an ASCII file parsed with the
  21.        following ReadArgs() template:
  22.  
  23.            STRINGS/M,CENTER=CENTRE/S,INV=INVERSE/S,FN=FONTNAME/S,
  24.            DPI/K,FG=FOREGROUND/K,BG=BACKGROUND/K
  25.  
  26.        STRINGS are multiple texts that are to be rendered instead of the
  27.        default character set. Each string is rendered in one line.
  28.        CENTRE indicates that each line should be centered on screen.
  29.        INVERSE indicates foreground/background color inversion. Does not
  30.        work for color fonts.
  31.        FONTNAME indicates that for each font's size the name and size of
  32.        that font should be rendered before any user text.
  33.        DPI describes font's aspect ratio, in XDPI/A/N,YDPI/A/N format.
  34.        Default values for aspect ratio are DiskFont's defaults.
  35.        FOREGROUND describes foreground color for two-color fonts. The string
  36.        is parsed with R=RED/A/N,G=GREEN/A/N,B=BLUE/A/N template to extract
  37.        red, green and blue components for a given color. Default foreground
  38.        color is black. This option does not work for color fonts.
  39.        BACKGROUND describes background color for two-color fonts. The string
  40.        is parsed with R=RED/A/N,G=GREEN/A/N,B=BLUE/A/N template to extract
  41.        red, green and blue components for a given color. Default background
  42.        color is white. This option does not work for color fonts.
  43.  
  44.    METHODS
  45.        OM_NEW -- Create a new picture object from a .font file and all
  46.                  associated size files. The source must be a file.
  47.  
  48.    NOTES
  49.        Since version 39.4 a font to be loaded does not need to be in
  50.        FONTS: path. The data type will temporarily extend FONTS: assign
  51.        to cover given font.
  52.        If bitmaps are created for an outline font, the data type will load
  53.        only those sizes, for which bitmaps exist. Otherwise all DiskFont
  54.        default sizes will be loaded.
  55.        For color fonts the color is set to that of biggest size.
  56.  
  57.    BUGS
  58.        Loading outline fonts with multiple size requires 'a lot' of memory.
  59.        OpenDiskFont() uses a lot of stack and this causes problems with
  60.        small-stack clients like original IPrefs.
  61.  
  62.    SEE ALSO
  63.        picture.datatype, diskfont.library, bullet.library.
  64.  
  65.